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The following is a description of commands used in creating seemingly 
difficult video displays using players and missiles. Used alone or in combina¬ 
tion with the other available systems byValpar International, it is possible to 
obtain graphic displays which compare with those of the best arcade games. The 
use of players and missiles (also called "player/missiles") allows the beginner 
to create high quality moving video displays. 
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VALPAR INTERNATIONAL 


Disclaimer of Warranty 
on Computer Programs 


All Valpar International computer programs are distributed 
on an "as is" basis without warranty of any kind. The total 
risk as to the quality and performance of such programs is with 
the purchaser. Should the programs prove defective following 
their purchase, the purchaser and not the manufacturer, distributor, 
or retailer assumes the entire cost of all necessary servicing or 
repair. 

Valpar International shall have no liability or responsibility 
to a purchaser, customer, or any other person or entity with 
respect to any liability, loss, or damage caused directly or 
indirectly by computer programs sold by Valpar International. 

This disclaimer includes but is not limited to any interruption 
of service, loss of business or anticipatory profits or conse¬ 
quential damages resulting from the use or operation of such 
computer programs. 

Defective media (diskettes) will be replaced if diskette!s) 
is returned to Valpar International within 30 days of date of sale 
to user. 

Defective media (diskettes) which is returned after the 30 day 
sale date will be replaced upon the receipt by Valpar of a $12.00 
Replacement Fee. 
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As knowledge of the internal workings of pi ayer/missile graphics is not 
necessary to use this valFORTH package effectively, the internal workings are 
not explained in this manual. However, for the serious programmer trying to 
optimize his/her program in every way, an understanding of these internal 
workings could at times improve code efficiency and/or speed of execution. 

For a complete explanation of player/missile graphics at the nut-and-bolt level, 
see the series of articles by Dave and Sandy Small in Creative Computing. 
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STROLLING THROUGH PLAYER/MISSILE GRAPHICS 

One of the biggest differences between the Atari graphic capabilities and 
those of most other computers is the Atari’s ability to use players and missiles. 
This discussion will not explain the internal workings of player/missile graphics 
on the Atari; rather, it will explain how to use the basic commands in this 
valFORTH package. Before we proceed, please load the player/raissile graphic 
routines from the Player/Missile disk. The directory on screen 170 will show 
what screen to load. Also, if you have the val FORTH Editor/Utilities package, 
load in the high speed STICK command found in the Miscellaneous Utilities; 
otherwise, load in the slower version on your PTayer/Missile disk. (Check the 
directory for its location). 


To start with, let's get a simple player up on the screen to experiment with. 
First we must initialize the player/missile graphic system and design the player's 
image. This is simple: 


1 PMINIT ( 

2 BASE ! ( 

LABEL CROSS ( 

00011000 C, 

00011000 C, 

00011000 C, 

11111111 C, { 

11111111 C, 

00011000 C, 

00011000 c, 

00011000 c, 

DECIMAL { 

PMCLR ( 

ON PLAYERS { 


CROSS 8 180 50 0 BLDPLY 


Initialize for single 
resolution players ) 

Change to binary for ease ) 

Give the player image a name ) 

A large plus sign ) 

Now back into base 10 ) 

Clear player/missile memory ) 
Turn on the players ) 

{ Build a piayer ) 


You should now see the cross in the upper right-hand corner of the video screen. 
Now let’s take a look at this and see how it works. 

First, players are initialized using the PMINIT command. Players can be in 
either a single or double resolution mode (double res players are twice as tall). 
"1 PMINIT" is used for single res players. If we had wanted double res players, 
we would have used "2 PMINIT". 

Next, the player image is created. Since it is much.easier to make player 
images as I's and O’s, we use binary (base two) number entry. Before we design 
the image, it must be given a name. The LABEL command does this nicely for us. 
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This image is named CROSS. All that need be done now is to draw the picture. 
Notice how easy it is to see the image when using base two. Of course, we could 
have stayed in base 10 and still designed the image, but this is usually more 
difficult. The word C, after each number simply tells FORTH to store that number 
in the dictionary. Once the picture is designed, we return to decimal for ease. 

Both the PMCLR and ON PLAYERS coranands are fairly self-descriptive: PMCLR 
erases all players and missiles so that no random trash appears when the PLAYERS 
are turned ON. Next, the BLDPLY (build player) command takes the image named 
CROSS which is 8 bytes tall and assigns it to player 0 at horizontal location 180 
and vertical location 50 on the display. Of course, we could have built player 
1, 2, or 3 instead. 

The cross should be black. Suppose we wanted a blue or green cross instead. 
This can be done using the PMCOL (piayer/missile color) command. Try this: 

098 PMCOL ( player hue lum PMCOL ) 

The cross should now appear blue. This command assigns a BLUE (9) hue with a 
luminance of 8 to player 0. If the color commands are loaded from the valFORTH 
disk. 


0 BLUE 8 PMCOL 

could have been used with the same results. Try changing the color of the player 
to GREEN (12) or PINK (4). Note that the default colors for players 2 and 3 make 
them invisible: Their colors should be set immediately upon being built. 

Mow that we have a player on the screen, let's move it around. We use the 
PLYMV (player move) command for this. PLYMV needs to know which player to move 
(there could be as many as five), how far to move it in the horizontal direction, 
and how far to move it in the vertical direction. Try this: 

110 PLYMV ( horz vert player PLYMV ) 

This moves player 0 down 1 line and right one horizontal position, thus giving the 
effect of a diagonal move towards the lower right-hand corner. Try these as well: 


1 0 0 PLYMV 

-5 0 0 PLYMV 

0 20 0 PLYMV 
0 -15 0 PLYMV 
-5 2 0 PLYMV 


( move right one position ) 

( move left five positions ) 

( move down 20 lines ) 

( move up 15 lines ) 

( move left five, and down two ) 


That's all there is to moving a player. Positive horizontal offsets move the 
player right, and negative values move the player left. Likewise, positive 
vertical offsets move the player down while negative ones move the player up. 
The following program can be typed in and you will have a joystick controlled 
player: 
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: JOY 
BEGIN 

0 STICK ( STICK leaves two offsets ) 

0 PLYMV ( for PLYMV to use. ) 

7TERMINAL 
UNTIL ; 

JOY <ret> 

Move the player with stick 0, the left-most stick port. Press any console button 
to exit the program. 

Currently, if the player is moved off any edge, it "wraps" to the opposite 
side. In other words, we have an "unbound" player. This is rarely desirable. 
Normally, we want to restrict player movement to certain boundaries. The PLYMV 
command has a built in boundary check routine specifically for this reason. 

Right now, new boundaries are set so wrapping occurs. Let's set some boundaries: 

60 150 50 200 0 PLYBND 

This sets the boundaries of player zero to 75 on the left, 150 on the right, 50 
on the top, and 200 on the bottom. Type JOY again to verify that you can no 
longer move freely about the display. Try different boundary settings and 
experiment to get the feel of the command. Boundary checking can be disabled 
for any or all of the edges. Setting the left or upper boundary to 0 will 
disable the check on that edge, likewise, 255 in either the right or lower 
boundary will do the same. 

Let's build another player in the lower right-hand corner of the screen. 

This time, instead of designing the player ourself, let’s borrow the image 
from the standard Atari character set stored in ROM. The image of the digit 
zero starts at address 57472. The other numbers follow zero. Try this: 

57472 16 160 150 1 BLDPLY 

You should now see the numbers 0 and 1 on your screen. This command builds 
player 1 with the image at address 57472 that is 16 bytes tall and puts it at 
horizontal position 160 and vertical position 150. Give this player a color 
if you want. 

Until now, we have been using normal size players. It is possible to make 
the two players on the display different widths using the PLYWID command. 

PLYWID expects a width specification of 0 or 2 (normal), 1 (double), or 3 
(quadruple). Its command form is; 

width player PLYWID 

Thus, 


3 1 PLYWID 

should make player one four times its original size. The same can be done with 
player zero: 


3 0 PLYWID 
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Type JOY again and notice that the width has no effect on movement v/hatsoever. 
Also notice that player one is unaffected by movement of player zero. 

Now that we have tv/o players on the screen, let's interface both of them 
to the joystick. Type in the following program: 

: J0Y2 
BEGIN 
0 STICK 
2DUP 

0 PLYMV 
SWAP 

1 PLYMV 
7TERMINAL 
UNTIL ; 

J0Y2 <ret> 

Notice that when you push the stick up, player zero goes up, but player one 
moves left. The SWAP instruction exchanges the vertical and horizontal offsets 
from STICK before moving player one. If we were to take the SWAP out, the 
players would move identically. 

In many applications, it is necessary to know when a player has hit another 
player or some background image. Fortunately, the Atari computer automatically 
makes this information available. An entire collection of valFORTH words allows 
checking of all collisions possible. The most general word is ?C0L which simply 
returns a true flag if anything has hit anything else. Here is an example: 

: BUMP 
BEGIN 
HITCLR 
0 STICK 
0 PLYMV 
?C0L 
IF 

CR ." oops!" 

ENDIF 
YTERMINAL 
UNTIL ; 

BUMP <ret> 

Move the player around and watch the results. Every time you hit any letters 
or player one, the word "oops!" should be printed out. This program is quite 
simple. First, the HITCLR command is issued which erases any old collision 
information. If this command were omitted, the first time a collision occurred, 
"oops!" would be continuously printed out. Next the joystick is read and the 
player moved. If the player touches anything when moved, the collision 
registers are set. ?C0L reads these registers and leaves a true flag if the 
player has hit something, and the IF statement will then print out "oops!". 


( Record stick moverent ) 

( Make a copy ) 

( Move player 0 ) 

( Rotate stick 90 degrees ) 
( Move player 1 ) 
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Using other commands found in the glossary, we can tell specifically what 
the player has hit. For example, the ?PXPF command checks to see if a specific 
player has hit a playfield, and if so, it returns information indicating which 
playfield. 

Although this discussion was limited to using players, the routines for 
missiles function similarly and can be found in the following glossary. Two 
player/missile example programs can be found on your Player/Missile disk. 

These demonstrate how short player/missile routines can be. 
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PLAYER/MISSILE GLOSSARY 


Enabling Player-Missile Graphics 

To make use of players and missiles, the video processor must be activated. 
Players can be several sizes, they can have different overlap priority schemes, 
and they can have different colors. The following collection of "words" makes 
this setup task quite simple. Note: Players and missiles are numbered 0 through 
3. The fifth player is numbered as four. 


(PMINIT) ( addr res —- ) 

The (PMINIT) command (or PMINIT below) must be used to initialize 
the player missile routines before any other player missile command may 
be used. (PMINIT) expects both the address of player/missile memory 
and a 1 or a 2 indicating whether single or double resolution is desired. 

NOTE: The difference between single and double resolution is shown 
graphically below: 


Player as defined 

single res 

double res 

in memory: 

on screen: 

on screen: 

00011000 

8S 

aa 

00111100 

esia 

aa 

01111110 

■•••■a 

aaaa 

00111100 

••aa 

aaaa 

00011000 

ae 

aaaaaa 

aaaaaa 

aaaa 

aaaa 

aa 

aa 


PMINIT ( res — ) 

The PMINIT command functions identically to the (PMINIT) corrmand 
above, except that no address need be given. PMINIT calculates an address 
based on the current graphic mode. It uses the first unused 2K block of 
memory below the highest free memory (‘i.e., below the display list). 

This should only be used while first learning the system, after that, 
(PMINIT) should be used to optimize memory utilization. Note that the 
variable PMBAS contains the calculated address upon return. 

PMBAS ( — addr ) 

A variable containing the address of player/missile memory. This 
value must lie on a 2K boundary if single resolution players are used 
and on a IK boundary if double resolution players are used. This is set 
using the (PMINIT) command and is automatically set by the PMINIT command 
described above. This value should never be set directly, but can be 
read at any time. 
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PLAYERS ( ON/OFF -- ) 

If the flag found on the top of the stack equates to TRUE or ON, 
then the player/missiles are activated. This does not clear out player 
missile memory; therefore, the PMCLR command described below is usually 
used prior to enabling the players and missiles to ensure that no random 
trash appears on the screen. 

If the flag found on the top of the stack equates to FALSE or OFF, 
then the player/missile graphic mode is de-activated. Turning players off 
does not clear player-missile memory; therefore, a subsequent ON PLAYERS 
conmand would redisplay any previously defined players and missiles. 

If players are already disabled, the command is ignored. 

5THPLY ( flag — ) 

In many applications it is desirable to combine the four missiles and 
simulate a fifth player, thus giving five players (numbered 0-4), and no 
missiles. If the flag on the stack is non-zero, then the fifth player mode 
will be initiated; otherwise, the missile mode will be re-activated. 

Normally, missiles take on the color of their corresponding players; 
however, when a fifth player is asked for, all missiles take on the common 
color of playfield #3. In addition, it also allows the fifth player to be 
treated exactly as any other player would be treated. Bear in mind that 
although it is called a "fifth" player, its reference number is four (4). 

The fifth player is "built" with missile zero on the right, and missile 
^ three on the left: 

|m3lm2|mllm0! = fifth player 

(Note; For convenience, the words ON and OFF have been defined to allow 
niceties such as: 

ON 5THPLY 
OFF 5THPLY 

These two words are recognized by all words that require an ON/OFF type 
indication.) 

PLYCLR ( Pl# — ) 

Few applications use all available players. To keep these unused 
players from displaying trash, they can be cleared of aVI data by 
using the PLYCLR command. The PLYCLR command expects the player number 
on the top of the stack and fills the specified player with zeroes. 

This command can be used to "turn off" players which are no longer 
needed. 

MSLCLR ( ml# — ) 

The MSLCLR command is very much like the PLYCLR comnand, described above, 
except that it clears the specified missile. In addition, this can be 
used when the fifth player is activated to erase parts of the fifth player 
for special effects. 
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PMCLR ( ) 

This cortmand clears all players and all missiles. This is generally 
used just prior to activating the player-missile graphic mode to ensure 
that no random trash is placed on the video screen. PMCLR expects no 
values on the stack, nor does it leave any. 


MCPLY { F -- ) 

The MCPLY (Multi-Color Player) command expects one value on the top 
of the stack. If this value is 0 or OFF, then the multi-color player mode 
is disabled. If this value is 1 or ON, this command instructs the video 
processor to logically "or" the bits of the colors of player zero with 
player one, and also of player two with player three. In other words, 
when players 0 and 1 overlap (or players 2 and 3), a third color (determined 
by the colors of the overlapping players) will be assigned to the overlapped 
region rather than assigning one of the players a higher priority. Since 
players must be one color, this allows for multi-colored players. For 
example: 


Player 0 

Player 1 

MCPlayer 

Pink color 

Blue color 

Pink/blue 

( 4 ) 

( 8 ) 

( 4 OR 8 
= green ) 


B8BB 

BBBB 


BBBBBBBB 

BBBBBBBB 

PPPPPPPP 


PPPPPPPP 

PPPPPPPP 

BB BB 

PGGPPGGP 

PPPPPPPP 


PPPPPPPP 

PP PP 


PP PP 

PPPP 


PPPP 

NOTE: The lums of 

the two players 

are also OR'd. 


The PRIOR command expects one value on the top of the stack. This 
value must be 8, 4, 2, or 1, otherwise unpredictable video displays may 
occur. PRIOR instructs the video processor as to what has higher priority 
for a video location on the screen. For example, it will determine whether 
a plane (a player) will pass in front of a building (a playfield), or 
whether the plane will pass behind the building. Objects with higher 
priorities will appear to pass in front of those with lower priorities. 

The following table shows the available priority settings: 
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n=8 n=4 n~2 n=l 


PFO 

PFO 

PLO 

PLO 

PFl 

PFl 

PLl 

PLl 

PLO 

PF2 

PFO 

PL2 

PLl 

PF3* 

PFl 

PL3 

PL2 

PLO 

PF2 

PFO 

PL3 

PLl 

PF3* 

PFl 

PF2 

PL2 

PL2 

PF2 

PF3* 

PL 3 

PL3 

PF3* 

BAK 

BAK 

BAK 

BAK 


* PF3 and PL4 share the same priority 


Objects higher on the list will 
lower on the list. 


appear to pass in front of objects 
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CREATING PLAYERS AND MISSILES 

Once the player/missile graphics system has been activated and the 
priorities set, all that need be done is to create the players themselves. 
Normally, this would be quite difficult to do; however, using the commands and 
designing techniques described below, this task is made very simple. 

There are really only three things to do in the creation of a player: setting 
the width size, setting the color, and creating the picture. 


PLYWID 


( width pi# — ) 


The PLYWID command sets the specified player to the desired width. 
Players are numbered 0, 1, 2, 3, or in the case of the fifth player, 4, 
Legal widths are: 

image: 10111101 


0 = normal width: 

1 = double width: 

2 = normal width: 

3 = quad, width: 


e eees e 

68 @8688888 86 

8 @868 8 

8888 8686888888888686 6868 


Any other value may cause strange results. 
MSLWID 


( size ml# — ) 


The MSLWID command is identical to the PLYWID command described above 
except that it is used to set the size of the missiles. The same size 
values apply also. The MSLWID command should only be used when in the 
missile mode (i.e., with the fifth player deactivated). 

PMCOL ( pi# hue lum — ) 

To set the color (hue and lum) of a player, the PMCOL (Player- 
Missile-Color) cormnand is used. It sets the specified player to the hue 
and lumina desired. Note that there.is no corresponding command to set 
the colors of missiles as missiles take on the colors of their respective 
players. To set the color of the 5th player, "pi#" should be 4. If the 
color words on the valFORTH 1.1 disk are loaded, they can be used to set 
player colors: 



0 BLUE 8 PMCOL 

This sets player #0 to a medium blue color. 
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BLDPLY 


( addr len horz vert pi# — ) 






The BLDPLY command is probably the most useful of all the commands in 
this graphic package. It takes an easily predefined picture that resides 
in memory at address "addr" whose length is "len" and converts it to the 
specified player "pi#". It then positions the player at the coordinates 
(horz,vert). The player is then ready to be moved about the screen using 
the PLYMV conmand described below. 


As an example, a player in the form of an arrow pointing upward will 
be created, assuming that priorities and such have already been taken care 
of. Practice has proven that the following method is easiest for creating 
players: 


2 BASE 


( put into binary mode ) 


LABEL PICTURE 
00011000 C, 
00111100 C, 
01111110 C, 
11011011 C, 
00011000 C, 

00011000 c, 
00011000 c, 
ooonooo c, 

DECIMAL 


the image is named PICTURE ) 


1 pmINIT ( initialize for single resolution ) 

PICTURE 8 80 40 0 BLDPLY 


Takes the image at location PICTURE which is 8 bytes long, and builds 
player #0 at location (80,40). 

BLDMSL ( addr len horz vert ml# ) 


The BLDPLY command described above does just about everything necessary 
to create a high-resolution player. The BLDMSL command functions identically 
to the BLDPLY command except that it is used for setting up missiles (which 
are in effect just skinny players). The method for creating players can be 
used for creating missiles as well. Note that if the fifth player mode is 
activated, the BLDPLY conmand must be used to create the player. 


Building missiles takes a bit more care than building players. Players 
occupy separate memory, while the four missiles share the same memory. 

Each missile is two bits wide; all four together are exactly a byte wide. 
Missile memory is shared with the two lowest bits devoted to missile zero, 
and the two highest bits devoted to missile three: 

I m3 I m3 1 m2 I m2 I ml I ml I mO I mO I 

All players with the same shape can use the same image without any problem 
since they all are a full byte wide. Missiles, however, cannot use the 
same shape since their images must be ORed into missile memory. This means 
that the missile images must be in the proper bit columns. For example, 
the same image for separate missiles could be: 


11000000 

11000000 

11000000 

msl#3 


00110000 

00110000 

00110000 

msl#2 


00001100 

00001100 

00001100 

msl#l 


00000011 

00000011 

00000011 

msl#0 
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PUTTING PLAYERS AND MISSILES IN THEIR PLACE 


Generally, once a player or missile has been created and put to the video 
screen, it is moved around. This can be accomplished very easily with the next 
set of words. Interfacing a movable player with the joystick can improve just 
about any program which requires input. As a result, it usually gives the 
program a more professional appearance. 

PLYLOC ( pi# —- horz vert ) 

The PLYLOC command {PLaYer LOCation) returns the vertical and 
horizontal positions of the specified player. This is normally used 
when a joystick/button setup is being utilized -- i.e., when a joystick 
is moving a player and the button is used to pinpoint where the player 
is. A program which draws lines between two dots could use this. The 
joystick is used to move the player to the desired spot on the screen. 
Pressing the button tells the program that a selected spot has been made. 
Once a second spot has been selected, the program then draws a line 
between them. 

MSLLOC ( ml# — horz vert ) 

The MSLLOC command performs the same function as the PLYLOC conmand 
described above except that it is used to find locations of missiles 
instead of players. Note that using MSLLOC on a fifth player gives 
meaningless results. 


PLYMV { horz vert pi# — ) 

The PLaYer MoVe command moves the specified player the direction 
specified by "vert" and "horz". If "vert" or "horz" is negative, the 
player is moved up or left respectively, otherwise it is moved down or 
right unless they happen to be zero in which case nothing happens. The 
following examples clarify this: 


0-50 PLYMV 
-1 -1 3 PLYMV 
3-1 2 PLYMV 


( Move player 0 up 5 lines ) 

( Move player 3 left and up one line ) 

( Move player 2 up one dot and right 3 ) 


MSLMV ( horz vert ml# — ) 

The' MSLMV is identical in function as the PLYMV command described 
above except that it is used to move missiles about the video screen. 


PLYPUT { horz vert pi# — ) 

The PLYPUT command positions player "pi#" to the location (horz,vert) 
on the video screen. 
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PLYCHG 


( addr len pl?f 


Oftentimes it is necessary to change the image of a player after it 
has been built. The PLYCHG command allows this to be easily done. The 
PLYCHG command takes the image with length "len" at address "addr" and 
assigns it to player "pi#". Note that if the new image is shorter than 
the previous one, part of the previous image will remain. This can be 
overcome by executing a PLYCLR command prior to PLYCHG. 


PLYSEL 


( addr # pi# -- ) 


The PLYSEL command is used to select image "#" out of a table of 
images of the same length and assigns that image to the specified player. 
PLYSEL is typically used to animate players. An example usage of this can 
be found in Player/Missile Example #2 found in the directory of the disk. 
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PLAYER/MISSILE BOUNDARIES 


It is often desirable to put limitations on the movements of players 
and missiles. Boundaries can be set up for each player and missile independently 
and upon each move conroand, they will remain within those boundaries. Additionally, 
a boundary status byte for each player is available for scrutiny at any time. 

This section explains how this is used. 

PLYBND { left right top bottom pi# -- ) 

In most applications, the movements of players are kept within certain 
boundaries. The PLYBND command frees the user from having to worry about 
boundary checking. This command expects the player number and all four 
boundaries. Whenever a PLYMV is then used, the player is always kept 
within the set boundaries. Also, upon each move a boundary status byte 
is left in the c-array PLYSTT (see?PLYSTT below). The edge boundaries of 
the screen are: 


32 for single, 16 for double 


48 for both 
resolutions 


223 for single. 111 for double 

Note that in special cases the boundary checker will fail. If the 
left boundary is 0 and the player is at the boundary, any move left will 
not be checked as expected. For example, if it were moved left by one 
position (“1), the new horizontal position would be -1 or FFFF in hex. 
Since only 8 bit unsigned comparisons are made, the horizontal position 
appears to be 255 (FF hex). Post calculating boundary checking turns 
out to be more useful because it allows any or all edges to be unbounded. 
If an unbounded player is desired, use this: 

0 255 0 255 pi# PLYBND 

For an example of PLYBND, see the example program found in the directory 
on screen 170 of your disk. 

MSLBND ( left right top bottom ml# -- ) 

The MSLBND command is the same as the PLYBND command above, except 
that it is used for missiles. Upon each move a boundary status byte is 
left in the array MSLSTT. See ?MSLSTT below. 


207 for both 
resolutions 
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1.0 


?BND ( — n ) 

This command leaves the boundary check status of the last PLYMV or 
MSLMV performed. The value has the following form: 


0 

1 0 

• • • 

0 

1 

r 

t 

b 

15 

14 


4 

3 

2 

1 

0 


Only the lower four bits are of use. Each bit represents a different 
edge. If the bit is set, then the player or missile has attempted to move 
beyond that boundary. Note that only two of the four bits can be set at 
any time. 

Note: DECIMAL 

?BND 3 AND 

IF hit-vertical-boundary ENDIF 
?BND 12 AND 

IF hit-horizontal-boundary ENDIF 


?PLYSTT ( pi# — val ) 

Given a player number, returns the boundary check byte of that player. 
This byte is the status byte for the most recent PLYMV of that player. 

See ?BND above for the description of the status byte, 

^ 7MSLSTT ( ml# val ) 

Given a missile number, returns the boundary check byte of that missile. 
This byte is the status byte for the most recent MSLMV of that missile. 

See ?BND above for the description of the status byte. 
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CHECKING FOR INTERACTION BETWEEN PLAYERS 

All the commands given so far allow the creation of any player or missile 
desired. But once that player is on the screen and moving around, it is often 
necessary to know when two or more objects (players, missiles, and playfields) 
touch or "crash" into each other. This remaining collection of commands allows 
checking of all possible "hit" combinations, 

?C0L ( f ) 

The ?C0L conmand is a very general collision detector. It does nothing 
more than indicate whether two or more objects have "crashed" — it does not 
give any indication of what has collided. It leaves a 1 on the stack if a 
collision has taken place; otherwise it leaves a zero. 


?MXPF ( ml# — n ) 

The ?MXPF command is a much more specific collision detection command. 
It stands for "?collision of Missile #X with any PlayField". It is used 
to check if a specific missile has hit any playfield. It returns a zero 
if no collision has taken place, and leaves an 8, 4, 2, 1, or combinations 
of these je.g., 12 = 8+4) if a collision has occurred. Each of these 
four basic values represents a specific playfield: 


3 ?MXPF ( Has missile #3 hit any playfields? ) 


TOS 

binary 

meaning of val 

0 

0000 

no collisions 

1 

0001 

with pf#0 

2 

0010 

with pf#l 

3 

0011 

with pf#0,l 

4 

0100 

with pf#2 

5 

0101 

with pf#2,0 

6 

0110 

with pf#2,l 

7 

0111 

with pf#2,l,0 

8 

1000 

with pf#3 

9 

1001 

with pf#3,0 

10 

1010 

with pf#3,l 

11 

1011 

with pf#3,l,0 

12 

1100 

with pf#3,2 

13 

1101 

with pf#3,2,0 

14 

1110 

with pf#3,2,l 

15 

1111 

with pf#3,2,l,0 




To test for a collision with one specific playfield, use one of the 
following: 


1 AND 

2 AND 
4 AND 
8 AND 


( Leaves 1 if collision with pf#0, 
( " 1 " " pf#l, 
{ " 1 " " pf#2, 
( " 1 " " pf#3. 


else 0 ) 

" 0 } 

" 0 ) 

" 0 ) 
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?PXPF ( pi# — n ) 

The ?PXPF command (?collision of Player #X with any PlayField) 

behaves in exactly the same manner as the ?MXPF conmand above except that 

it tests for collisions with players and playfields instead of missiles 
and playfields. 

?MXPL ( ml# — n ) 

The 7MXPL command (?collision of Missile #X with any Player) behaves 
in exactly the same manner as the 7MXPF command above except that it 
tests for collisions between missiles and players. Note that it is 
impossible for a missile to collide with a fifth player since it would be, 
in effect, colliding with itself. 

?PXPL ( pi# — n ) 

The ?PXPL command (?collision of Player #X with any other players) 

behaves in exactly the same manner as the ?MXPF command above except that 

it tests for collisions between players. Note that it is impossible for 
a player to collide with itself. 

HITCLR ( — ) 

The HITCLR command clears all collision registers. In other words, 
it sets the collision monitor to a state which indicates that no collisions 
have occurred. 
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THE CHARACTER SET EDITOR 


Character Sets 

Whenever the computer has to display a character on the video screen, it 
must refer to a table which holds the shape definition for that character. 

By changing this table, new character sets can be formed. 

The shape of a single character in the table (or character set) is made 
up of 8 bytes of data. A character is one byte wide and 8 bytes tall forming 
an 8 by 8 bit matrix. If a bit in this matrix is set (1), then a dot will 
appear on the screen. If a bit is reset (0), nothing is displayed. For 
example, the letter I could be defined as: 



00000000 

$00 = 0 

§@8990 

01111110 

$7E = 126 

19 

00011000 

$18 = 24 

99 

00011000 

$18 = 24 

98 

00011000 

$18 = 24 

89 

00011000 

$18 = 24 

898989 

01111110 

$7E = 126 


00000000 

$00 = 0 


Thus, the sequence 0, 126, 24, 24, 24, 24, 126, 0, represents the letter I. 

The entire alphabet is constructed in this fashion. By selectively setting 
the bit pattern, custom made characters can be formed. This can find many 
uses. A British character set can be made by changing the one character "#" 
to the British monetary symbol. Likewise, a Japanese character set could be 
made by replacing the lowercase characters with Katakana letters. 

Another use would be to design special symbol sets. For example, an 
entire set could be devoted to special mathematical symbols such as plus-minus 
signs, square-root signs integration signs, or vector signs. (Although this 
would be of little use in normal operation where character sets cannot be mixed 
on the same line, using the high resolution text output routines in the 
Editor/Utilities package. It becomes easy to mix character sets in this 
fashion.) Assuming the character sets were defined, it would be possible to 
have a Japanese quotation (in kana of course) embedded within the text of a 
mathematical explanation of some kind all on the same line! 

A final use for custom character sets is for "map-making." Characters 
can be designed so that they can be pieced togehter to form a picture. An 
excellent example of this can be found in Cris Crawford's Eastern Front game 
available through the Atari Program Exchange. When done properly, the final 
"puzzle" will appear as though it is a complicated high resolution picture. 





The following description explains how to use the character editor found on 
the Player/Missile disk. This editor allows a character set to be designed and 
then saved on disk for later modification or use. A copy of the standard 
character has already been saved and can be located through the directory on 
screen 170. 

After loading the character editor, it is executed by typing: 

CHAR-EDIT <ret> 

The screen has an 8 by 8 grid in the upper-lefthand corner. On the right side 
there is a command list, and at the bottom, a section is reserved to display 
the current character set. 


The Commands: 

I) The joystick 

A joystick in port 0 (the leftmost port) is used to move the 
character cursor (the solid circle) within the 8 by 8 grid. The 
cursor indicates where the next change to the current character 
will be made. 

II) The button 

When pressed, the joystick button will toggle the bit under the 
character cursor in the 8 by 8 grid. If the bit is set (on), it 
will be reset. If the bit is reset (off), it will be set. The 
character will be updated in the character set found at the bottom 
of the screen. 

Ill) "1" command 

By pressing the "1" the current character is cleared in both 
the grid and in the character set at the bottom of the display. 

There is no verify prompt for this command. 

IV) "2" cofimiand 

By pressing the *'2" key the current character and character 
set are cleared. User verification is required before any action 
is taken. 

V) "3" command 

By pressing the "3" key the current character is saved to disk. 
User verification is required with a yes/no response. If a yes 
response is given, a screen number is asked for and the current 
character set is saved on the specified screen. The current 
character is not destroyed upon a save. 

VI) "4" coimiand 

By pressing the "4" key a character set is loading from disk, 
destroying the current character set. User verification is required 
with a yes/no response. If a yes response is given, a screen number 
is asked for and a character set loaded from the specified screen. 



VII) 


" and commands 

These two arrow keys move the character pointer through the 
character set to allow modification of any character in the current 
set. 

VIII) Console key 

Pressing any console key terminates the edit session and returns 
control to the FORTH system. The current character set is lost 
unless it is saved to disk prior to ending the session. 


Loading Character Sets 

The following three words allow easy use of custom character sets. 


CHLOAD ( addr scr# cnt — ) 

The CHLOAD command takes the first "cnt" characters on screen "scr#" 
and stores them consecutively starting at address "addr". Each screen 
(in half-K mode) will only hold 64 character definitions. If "cnt" is 
greater than 64, CHLOAD will continue loading from the next screen. 

Many character sets could be loaded at one time by giving a very large 
"cnt" value. Besides being able to load a full set, the CHLOAD command 
allows the building of a new set from several other sets. 

Note that if a 20 character/1ine mode is being used, "addr" should 
lie on a half-K boundary (only upper 7 bits significant). If a 40 
character/line mode is being used, "addr" should lie on an IK boundary 
(only upper 6 bits significant). Also note that PAD is modified by 
CHLOAD. 


SPLCHR ( addr — ) 

The SPLCHR commands activates the character set at the address 
specified. 

NMLCHR ( ) 

The NMLCHR command re-activates the normal character set. 
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AUDIO-PALETTE - A SOUND EDITOR 


Audio-Palette is a sound editor which generates all possible time-in 
dependent sounds that the Atari 400/800 microcomputer can produce. Each of 
the four channels are interfaced to one of the four joystick ports. The joy¬ 
sticks allow the setting of the pitch (horizontal) the distortion (vertical) 
of their corresponding channel. When the joystick button is pushed, the 
sound is made. To get a better idea of how this works, load the editor 
(see screen 170) and type: 


AUDED <ret> 

The screen should clear and a table of values should appear at the bottom of 
the display. In the upper lefthand corner of the screen, there should be four 
numerals (players) overlayed (one for each channel). Each of these players 
can be moved around the display by' using a joystick in the appropriate port. 

As a player is moved vertically, the distortion changes. As a player is 
moved horizontally, the pitch changes. By pressing the button, a sound will 
be made according to the current frequency (pitch), distortion, volume, and 
audio control settings. To increase the volume, the up-arrow is used. Any 
time the up-arrow is pressed, all channels whose corresponding joystick 
buttons are pressed will have their volumes increased. Likewise, the down- 
arrow will decrease the volumes. 

Each bit of the audio control value performs some function in the 
sound generator. The bits are numbered 0 to 7. Pressing the keys 0 to 7 
will toggle the corresponding bits in the audio control register. For a 
description of these bit settings, please refer to the explanation of SOUND 
in the valFORTH 1.1 package. 




XXIV. PLAYER/MISSILE SUPPLIED SOURCE 




Screen 

: 30 



Screen; 33 


0 

( 1 

PlyMsl: arrays and variables) 

0 i 

PlyMsl: PMINIT PLAYERS 

) 

1 

BASE 0 



1 



£ 

DCX ’( ARRAY )( 80 

KLOAD ) 

£ : 

PMINIT ( res 

_) 

3 

0 

VARIABLE 

PMBAS 


3 

EES C@ 8 - Fa AND 


4 

5 

CARRAY 

PLYVRT 


4 

OVER 1- 4 * + 100 * 


5 

5 

CARRAY 

PLYHRZ 


5 

SWAP (PMINIT) 5 


G 

5 

CARRAY 

PLYLEN 


6 



7 

5 

ARRAY 

PLYADR 


7 ; 

PLAYERS ( f 

— ) 

8 

4 

CARRAY 

MSLVRT 


8 

IF 


9 

4 

CARRAY 

MSLHRZ 


9 

PMBAS 0 DUP 


10 

4 

CARRAY 

MSLLEN 


10 

PMRES 0 1+ (PMINIT) 


11 

4 

ARRAY 

MSLADR 


11 

SP@ 1+ C@ SWAP 


1£ 

5 

ARRAY 

PMADR 


1£ 

DROP D407 Ci 


13 

0 

VARIABLE 

PMLEN 


13 

SGRCTL 0 3 OR DUP 


14 

0 

VARIABLE 

PMRES 


14 

SGRCTL ! D0iD C! 


15 

0 

VARIABLE 

MSLSZ 

==> 

15 

ELSE 

—> 


Screen: 31 

0 < PlyMsl; arrays and variables) 
1 

£ 0 VARIABLE BOUNDS 34 ALLOT 

3 5 CARRAY PLYSTT 

4 4 CARRAY NSLSTT 

5 0 VARIABLE BNDCOL 

6 £ VARIABLE 5THWID 

7 

a CTABLE 5THDAT 
9 £ C, 4 C, £ C, 8 C, 

10 

11 HEX 
1£ 

13 CTABLE MSLDAT 

14 FC C, F3 C, CF C, 3F C, 

15 ““> 


Screen: 34 

0 ( PlyMsl: 5THPLY ) 

1 

£ S6RCTL 0 FC AND 

3 DUP SGRCTL ! D01D C! 

4 ££F Ce E3 AND £SF C! 

5 D00D 5 ERASE 

6 ENDIF ; 

7 

a 

9 : 5THPLY ( f — ) 

10 £6F C@ SWAP 

11 IF 10 OR 

1£ ELSE EF AND 

13 ENDIF 

14 £GF C! ; 

15 ==> 


Screen: 3£ 

0 ( PlyMsl: CPMINITl ) 

1 

£ : (PMINIT) ( addr res — ) 

3 SWAP PMBAS ! 1- DUP PMRES ! 

4 NOT 10 * 0C OR 

5 ££F C@ EF AND OR ££F C! 

6 PMBAS 0 180 PMRES 0 

7 NOT 1+ >R 

8 R * + DUP 4 PMADR ! 

9 80 R> * >R 

10 R + DUP 0 PMADR ! 

11 R + DUP 1 PMADR ! 

1£ R + DUP £ PMADR ! 

13 R + 3 PMADR ! 

14 R> PMLEN ! ; 

15 ==> 


Screen; 35 


0 ( 

1 

2 

PlyMsl: PMCLR 

PLYCLR ) 

3 : 

PMCLR 

( — ) 

4 

4 PMADR 0 


5 

PMLEN 05* 


6 

7 

8 

0 FILL ; 


9 : 

PLYCLR 

( pi# -- ) 

10 

PMADR 0 


11 

PMLEN 0 


1£ 

13 

14 

0 FILL ; 


15 


—> 




Screen: 36 

0 ( PlyMsl: MSLCLR PRIOR ) 

1 

£ : MSLCLR ( ml# — ) 

3 4 PMflDR 0 DUP 

4 PMLEN 0 + SWAP 

5 DO 

6 DUP MSLDfiT C@ 

7 I C0 AND I C! 

8 LOOP 

9 DROP ; 

10 

11 : PRIOR ( r, — ) 

12 26F C@ 0F0 AND 

13 OR 26F C! ; 

14 

15 ==> 


Screen; 39 

0 ( PlyMsl; PLYMV ) 

1 A5 C, N C, D5 C, 03 C, 90 C, 

£ 08 C, 18 C, 65 C, N 4 +■ C, 38 

3 C, E5 C, N 5 + C, 85 C, N C, 

4 18 C, 65 C, N 1- C, 85 C, N C, 

5 B5 C, 2 C, F0 C, 0B C, A0 C, 

6 00 C, 98 C, 88 C, CS C, 91 C, 

7 N C, C4 C, N 5 + C, D0 C, 

8 F9 C, B5 C, 00 C, C9 C, 04 C, 

9 D0 C, 14 C, B5 C, 05 C, A0 C, 

10 04 C, HERE 88 C, 30 C, 0A C, 

11 99 C, D004 , 18 C, 6D C, 5THWID 

12 , 4C C, , 4C C, HERE 2 ALLOT 

13 B5 C, 05 C, B4 C, 00 C, 99 C, 

14 D000 , HERE SWAP ! B4 C, 00 C, 

15 A5 C, N 6 + C, —> 


Screen: 37 

0 ( PlyMsl; PLYMV ) 

1 


Screen: 40 

0 ( PlyMsl; PLYMV ) 

1 


2 

CODE PLYMV 



2 

99 

c, 

0 

PLYSTT , 

8D 

c, 

BNDCOL 

3 

84 

c. 

N 6 + C, 

B5 C, 

00 C, 

3 

B5 

C, 


C, 18 C, 

65 

C, 

N 

1- C, 

4 

0A 

c, 

A8 C, B9 

C, 0 

PMADR 1+ , 

4 

85 

c, 

N 

C, A0 C, 

00 

C, 



5 

85 

c, 

N 1+ C, 

B9 C, 

0 PMADR , 

5 

B1 

c, 

N 

2+ C, 





6 

85 

C, 

N 1- C, 

B9 C, 

0 PLYADR , 

6 

91 

C, 

N 

c, ca C, 

C4 

c. 

N 

+ 

n 

7 

85 

c. 

N £+ C, 

B9 C, 

0 PLYADR 

7 

D0 

C, 

F7 C, E8 C, 

E8 C, 



8 

1 + 

? 

85 C, N 

3 + C, 

B4 C, 0 C, 

8 

4C 

C, 

POPTWO , 

C; 




9 

B9 

c, 

0 PLYLEN 

, 85 

C, N 4 + C, 

9 









10 

B9 

C, 

0 PLYHRZ 

, 18 

C, 75 C, 

10 









11 

04 

C, 

D9 C, BOUNDS , 

B0 C, 5 C, 

11 









12 

B9 

C, 

BOUNDS , 

E6 C, 

N 6 + C, 

12 









13 

06 

C, 

N 6 + C, 

D9 C, 

BOUNDS 5 + 

13 









14 

, F0 

C, 07 C, 

90 C, 

05 C, B3 C, 

14 









15 

BOUNDS 5 + , E6 C, N 

1 6 + C, —> 

15 










Screen; 

3 

8 


Screen; 41 



0 

< PlyMsl; PLYMV 

) 

0 

( PlyMsl: MSLMV 


) 

1 

99 

c, 

0 PLYHRZ , 

95 C, 05 C, 

1 

HEX 



2 

B9 

c. 

0 PLYVRT , 

85 C, N C, 

£ 




3 

18 

c, 

75 C, £ C, 

06 C, N 6 + C, 

3 

CODE MSLMV 



4 

D9 

c, 

BOUNDS A + 

, B0 C, 05 C, 

4 

84 C, N 6 + C, B5 C, 0 

c, 

0A C, 

5 

B9 

c, 

BOUNDS A + 

y E6 C, N 6 + 

5 

AS C, AD C, 4 PMADR 1+ 

1 

85 C, 

6 

c, 

6 

C, N 6 + C, 

D9 C, BOUNDS 

6 

N 1+ C, AD C, 4 PMADR , 

85 C, 

7 

F + , 

F0 C, 07 C, 

90 C, 05 C, 

7 

N 1- C, B9 C, 0 MSLADR 

9 

85 C, 

8 

B9 

c, 

BOUNDS F + 

, E6 C, N 6 + 

a 

N 2+ C, E9 C, 0 MSLADR 

1 + 

9 

9 

c, 

99 

C, 0 PLYVRT 

■ , 95 C, 3 C, 

9 

85 C, N 3 + C, B4 C, 0 

c, 

B9 C, 

10 

38 

c, 

E5 C, N C, 

B0 C, 05 C, 

10 

0 MSLDAT , 85 C, N 7 + 

c, 

B9 C, 

11 

A5 

c, 

N C, 38 C, 

F5 C, 03 C, 

11 

0 MSLLEN , 85 C, N 4 + 

C, 

B9 C, 

12 

95 

c, 

02 C, C5 C, 

N 4 + C, 

12 

0 MSLHRZ , 18 C, 75 C, 

04 

c, 

13 

90 

c, 

02 C, A5 C, 

N 4 + C, 

13 

D9 C, BOUNDS 14 + , B0 

c, 

5 C, 

14 

85 

C, 

N 5 + C, 


14 

B9 C, BOUNDS 14 + , E6 

c, 

N 6 + 

15 




==) 

15 



—> 



Screen: 4£ Screen: 45 


0 

1 

< PlyMsl: MSLMV ) 

0 

i 

( PlyMsl; 

BLDPLY 

BLDMSL 

2 

C, 

6 

C, N 6 + C, D9 C, BOUNDS 

X 

2 

: BLDPLY 

( 

a 

1 h V pi# 

3 

18 

+ 

, F0 C, 07 C, 90 C, 

3 

>R 



R PLYVRT C 

4 

05 

C, 

B9 C, BOUNDS 18 + , 

4 

R PLYHRZ 

C! 


R PLYLEN C 

5 

E6 

C, 

N 6 + C, 

5 

R PLYADR 

1 

( 

R PLYCLR ) 

6 

99 

c, 

0 MSLHRZ , 95 C, 05 C, 

6 

0 0 R> PLYMV 

■ 


7 

BS 

C, 

0 MSLVRT , 85 C, N C, 

7 





8 

18 

c, 

75 C, 02 C, 6 C, N 6 + C, 

8 

: BLDMSL 

( 

a 

1 h V pi# 

9 

D9 

C, 

BOUNDS 1C + , B0 C, 5 C, 

9 

>R 


R 

MSLVRT C! 

10 

B9 

C, 

BOUNDS 1C + , E6 C, N 6 + 

10 

R MSLHRZ 

C! 

R 

MSLLEN C! 

11 

c, 

06 

C, N 6 + C, D9 C, BOUNDS 

11 

R MSLADR 

! ( 

R 

MSLCLR ) 

12 

20 

+ 

, F0 C, 7 C, 90 C, 5 C, 

12 

0 0 R> MSLMV 

M 

9 


13 

B9 

c, 

BOUNDS 20 + , E6 C, N 6 + 

13 





14 

c. 

99 

C, 0 MSLVRT , 95 C, 3 C, 

14 





15 



II 

II 

15 






) 


— ) 


“ ) 


~> 


Screen; 

43 








0 

1 

( PlyMsl; 

MSLMV 




) 

X 

2 

3S 

C, 

E5 

1 C, 

N 

c, 

B0 

c, 

5 

C, A5 

3 

c, 

N 

c, 

38 

c, 

F5 

c, 

3 C 

'5 

95 C, 

4 

c! i 

c, 

C5 

c, 

N 4 

+ 

c, 

90 

c, 

2 C, 

5 

A5 

C, 

N 

4 + 

■ c, 

85 

i C, 

N 

5 

+ C, 

6 

A5 

c, 

N 

c, 

D5 

c, 

3 C 

, 90 

c, 

7 

8 1 

C, 

18 

c, 

65 

c, 

N 4 

4* 

C, 

38 

8 

c, 

E5 

1 C, 

N 

5 + 

c, 

85 

c, 

N 

c, 

9 

18 

c, 

65 

C, 

N 

1- 

c, 

85 

C, 

N C, 

10 

A0 

C, 

FF 

c, 

C8 

C, 

B1 

c, 

N 

c, 

11 

25 

C, 

N 

7 + 

■ c, 

91 

c, 

N 

c, 

C4 

12 

c, 

N 

5 + 

c, 

D0 

c, 

F5 

c, 

B5 C, 

13 

5 1 

n 

B4 

c, 

0 C 

, 99 C 

, D004 , 

14 











15 










—> 


Screen: 46 

0 ( PlyMsl: PLYCHG PLYSEL PLYPUT) 
1 

e : PLYCHG ( a len pi# — ) 

3 >R R PLYLEN C! 

4 R PLYfiDR i 

5 0 0 R> PLYMV ; 

6 

7 : PLYSEL < a # pi# -- ) 

8 >R R PLYLEN C@ * + 

9 R PLYLEN C@ R> PLYCHG ; 

10 

11 : PLYPUT < h V pi# — ) 

12 >R R PLYVRT C@ - 

13 SWAP R PLYHRZ C0 - 

14 SWfiP R> PLYMV ; 

15 ==> 


Screen: 44 

0 i PlyMsl: MSLMV ) 

1 

2 B4 C, 0 C, AS C, N 6 + C, 99 

3 C, 0 MSLSTT , 8D C, 

4 BNDCOL , B5 C, 3 C, 18 C, 

5 65 C, N 1- C, 85 C, N C, 

6 A0 C, 00 C, B1 C, N C, 

7 25 C, N 7 + C, 11 C, N 2+ C, 

8 91 C, N C, C8 C, 

9 C4 C, N 4 + C, D0 C, F3 C, E8 

10 C, ES C, 4C C, POPTWO , C; 

11 
12 

13 

14 

15 ==> 


Screen: 47 

0 ( PlyMsl: PLYWID ) 

1 

2 CODE PLYWID 


3 

B5 C, 

00 C, 

C9 C, 04 C, F0 

c, 

4 

09 C, 

A8 C, 

B5 C, 02 C, 99 

c, 

5 

D008 

, 4C C, 

HERE 2 ALLOT 


6 

A8 C, 

A0 C, 

04 C, 0A C, 0A 

c, 

7 

15 C, 

02 C, 

88 C, D0 C, F9 

c, 

8 

8D C, 

MSLSZ 

, 8D C, D00C , 


9 

B4 C, 

02 C, 

B9 C, 0 5THDAT 

9 

10 

85 C, 

N C, 

8D C, 5THWID , 


11 

AD C, 

4 PLYHRZ , A0 C, 04 C 


12 

HERE 
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Player/Missile Command Summary 

Note: Players and missiles are numbered 0 thru 3. The fifth player is numbered 4. 


(PMINIT) 

( addr res — 

) 

PMINIT 

{ res --- ) 


PMBAS 

( — addr ) 


PLAYERS 

( ON/OFF — ) 


5THPLY 

( ON/OFF -- ) 


PLYCLR 

MSLCLR 

PMCLR 

MCPLY 

{ — ) 

( ml# ) 

( — ) 

{ ON/OFF — ) 


PRIOR 

( n — ) 


PLYWID 

(. width pi# --- 

) 

MSLWID 

( width ml# 

) 

PMCOL 

( pi# hue lum • 

— } 

SLOPLY 

( addr len horz 
pH — ) 

vert 

BLDMSL 

( addr len horz 
ml # — ) 

vert 

PLYLOC 

( pi# --- horz 

vert ; 

MSLLOC 

( ml# horz 

vert ] 

PLYMV 

( horz vert pi# 

: 

MSLMV 

( horz vert ml# 

— ) 

PLYPUT 

( X y pi# - 

-) 

PLYCHG 

( addr len pi# 

— ) 

PLYSEL 

( addr # pi# -- 

-) 

PLYBND 

(1 r t b pH 

— ) 

MSLBNO 

(1 r t b ml# 

— ) 

?BN0 

( — n ) 


TPLYSTT 

( pH — n } 


TMSLSTT 

( ml# —- n ) 


?C0L 

{ — f } 


?MXPF 

( ml# --- n ) 


?PXPF 

( pH n ) 


?MXPL 

( ml# — n ) 


’PXPI.^ 

(pH — n ) 


HITCLR 

( ™ ) 



Initializes the player missile routines with 
PM memory specified by "addr" with "res" 
resolution. 

Initializes the player missile routines with 
res" resolution and with PM memory located 
at the first available memory below the 
display 1ist. 

A variable pointing to player/missile memory 
which is set by (PMINIT) or PMINIT. It can 
be read from but not written to. 

This command enables or disables the player/ 
missile graphic display. 

This command turns (the fifth player trode) 

ON or OFF. If OFF, missiles take the colors 
of their corresponding players. If ON, all 
missiles take on the comnon color of play* 
field 3. The fifth player is numbered as 
four (4). 

Erases the specified player (0-3,4). 

Erases the specified missile (0-3). 

Erases all players and all missiles. 

This comnand turns (the multiple color 
player mode) ON or OFF. See documentation 
for explanation. 

Sets the priority of jslayers and playfields. 
See documentation for legal settings. 

Sets the width of the specified player. 

Legal widths are normal (0 or 2), double (1), 
or quadruple (3). 

Sets the width of the specified missile. 

Legal widths are normal (0 or 2), double (1), 
or quadruple (3). 

Sets the specified player to the color 
defined by "hue" and "lum". 

Creates a player whose image is at "addr" 
with a length "Ten". The player is originally 
placed at the specified horizontal and 
vertical coordinates. 

Creates a missile whose image is at “addr" 
with a length "len". The player is originally 
placed at the specified horizontal arfd 
vertical coordinates. 

Returns the horizontal and vertical coordi¬ 
nates of the specified player. 

Returns the horizontal and vertical coordi¬ 
nates of the specified missile. 

Moves the specified player according to the 
horizontal and vertical offsets specified. 

A positive horizontal offset moves the player 
right, a negative one moves it left. Likewise, 
a positive vertical offset moves the player 
down and a negative one moves it up. 

Moves the specified missile according to the 
horizontal and vertical offsets specified. 

See PLYMV above. 

Positions the specified player and location 
(x,y) on the video display. 

This changes the image of the specified 
player to the image of length "len" at "addr". 
This changes the image of the specified 
player to image number in a table of 
images starting at address "addr". 

Specified the left, right, top, and bottom 
boundaries of the specified player. 

Specified the left,’ right, top, and bottom 
boundaries of the specified missile. 

Returns the boundary status of the last 
player or missile moved. See documentation 
for a description of this value. 

Returns the boundary status of the last move 
of the specified player. See documentation 
for a description of this value. 

Returns the boundary status of the last move 
of the specified missile. See documentation 
for a description of this value. 

Returns true (1) if any collisions have 
occurred since the last HITCLR conmand was 
issued. 

Returns 0 if the specified missile has not 
hit any playfields since the last iilTCLR 
command. If any collisions have occurred, 
a status value is returned. See documentation. 
Returns 0 if the specified player has not hit 
any playfields since the last HITCLR command. 

If any collisions have occurred, a status 
value is ret.urned. See documentation. 

Returns 0 if the specified missile has not 
hit any players since the last HITCLR cotinand. 

If any collisions have occurred, a status 
value is returned. See documentation. 

Returns 0 if the specified player has not 
hit any other players since the last HITCLR 
command. If any collisions have occurred, a 
status value is returned. 

Clears the collision registers to a no¬ 
collision state. 


Audio Editor Command Summary 

{ -' ) Calls up the audio-palette program. 

Character Editor Command Summary 

CHAR-EDIT ( -- ) Calls up the character editor. 


(Doubie resolution values are in parentheses) 


32 = $20 
(16) 


48 = $30- 
(Left) 


48- 




Video Screen 


32 

(16) 


-207 = 
(Right) 


-207 


223 = $DF 223 

(111 = $6F) 


$CF 
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Memory Map 

valFORTH 

T.y 


o 


SINGLE RESOLUTION 
PMBASE + 2048 

PMBASE + 1792 

PMBASE + 1536 

PMBASE + 1280 

PMBASE + 1024 

PMBASE + 768 


PMBASE 
(Must lie on a 
2K boundary) 


8 bits 


Player 3 


Player 2 


Player 1 


Player 0 


Missiles* 
(5th Player) 


Unused Memory 
Available to User 


DOUBLE RESOLUTION 
PMBASE + 1024 

PMBASE + 896 

PMBASE + 768 

PMBASE + 640 

PMBASE + 512 

PMBASE + 384 


PMBASE 
(Must lie on a 
1K boundary) 






*Note: All missiles occupy the same memory location. 

This is possible because unlike players whith 
are 8 bits wide and fill an entire byte, mis¬ 
siles are only two bits wide. Four missiles 
can therefore be represented in the same amount 
of memory as a single player. 

Byte form: ! m3 i m2 i ml : mO - 
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